home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / c / showobj.doc < prev    next >
Text File  |  1996-09-07  |  7KB  |  198 lines
  1. ---------------------------------------------------------------------------
  2.                                  Showobj V2.1
  3.            An Imagine TDDD-object and LightWave LWOB-object displayer.
  4.                        Copyright 1994,95 by Andreas Heumann.
  5.                               All Rights reserverd.
  6. ---------------------------------------------------------------------------
  7.  
  8. Requirements
  9. ============
  10.  
  11. Showobj requires at least OS 2.0, nevertheless it should run on any machine
  12. with any processor.
  13. Tested with:
  14. A2000 4Mb 68030/882 ECS
  15. A2000 9Mb 60040, Merlin Gfx Board
  16.  
  17. Introduction
  18. ============
  19.  
  20. Showobj takes a file in Imagine's TDDD (3D data description) or in
  21. LightWave's LWOB format and displays it's contents in a window on a public
  22. screen, or if no is given on Workbench. If no filename is given, the
  23. program will ask for it with a filerequester.
  24.  
  25. Showobj can display the objects in three different modes:
  26. - boundingbox mode
  27. - wireframe mode
  28. - solid mode
  29.  
  30. Four views can be selected:
  31. - front view
  32. - right view
  33. - top view
  34. - perspective view
  35.  
  36. In perspective view the object can be rotated with the mouse while
  37. pressing the left mouse button, and zoomed while pressing the right
  38. button
  39. In front, right and top view it can be moved with mouse while pressing
  40. the left button.
  41. With the cursor keys in object is moved in front, right and top view,
  42. and rotated in perspective view.
  43.  
  44. It`s possible to track the Camera in perspective mode to the objects,
  45. and get information about them. Objects tracking to are drawed in a
  46. different color.
  47.  
  48. Solid mode is realized with a Z-Buffer algorithm which will take a large
  49. amount of memory in high resolution modes (655kByte with 640x256,
  50. 1,8Mb with 800x600 and 3Mb with 1024x768).
  51. If there's not enough memory available the window is divided into stripes.
  52.  
  53. Inputs
  54. ======
  55.  
  56. TDDD: Can read and display:
  57.       - normal Objects saved in detail editor
  58.       - perfect spheres
  59.       - grounds
  60.       Can't read and display:
  61.       - Lamps
  62.       - Others than the first state of a state-object
  63.       - Others than the first state of a cycle-object
  64.       - Paths
  65.       - Objects saved in forms or spline editor
  66. LWOB: Can't diplay polygons with more than four points (rectangles)
  67.       in shaded mode.
  68.  
  69. Usage
  70. =====
  71.  
  72. showobj [verbose] [pubscreen <name>] filename
  73.  
  74. With:
  75.  
  76. verbose verbose mode, displays information about file
  77.         TDDD: names of Objects; amount of objects, faces, edges and points
  78.         LWOB: names of Surfaces; amount of surfaces, faces, edges and points
  79.  
  80. pubscreen opens showobj window on given pubscreen
  81.  
  82. filename  name of the TDDD-file which is displayed, if no name is given
  83.           a filerequester appears.
  84.  
  85. This keys can be used while displaying the object:
  86.  
  87. ESC  -  Quit
  88. HELP -  Showes keys used by showobj
  89. a    -  Showes informations about object
  90. w    -  Switches wireframe mode on
  91. b    -  Switches bounding box on
  92. s    -  Switches solid mode on
  93. f    -  Switches to front view
  94. r    -  Switches to right view
  95. t    -  Switches to top view
  96. p    -  Switches to perspective view
  97. i    -  Zoomes in
  98. o    -  Zoomes out
  99. n    -  Track to next object
  100. Cursorkeys to move in front, right and top view and to rotate in
  101. perspective view
  102.  
  103. Disclaimer
  104. ==========
  105.  
  106. Standard disclaimer:
  107.  
  108. THERE IS NO WARRANTY FOR THIS PROGRAM TO THE EXTENT PERMITTED BY APPLICABLE
  109. LAW.  EXCEPT WHERE OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR
  110. OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND,
  111. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  112. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE
  113. ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
  114. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  115. SERVICING, REPAIR OR CORRECTION.
  116.  
  117. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
  118. ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM
  119. AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
  120. SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  121. INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
  122. DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
  123. OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF
  124. SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  125. DAMAGES.
  126.  
  127. Copyright
  128. =========
  129.  
  130. Showobj 2.0 is Copyright 1994 by Andreas Heumann. All Rights Reserved. It is
  131. released under the concept of `Cardware'. So if you like it please send me
  132. a postcard of your city. It has never been, nor will it ever be in the
  133. `Public Domain'.
  134.  
  135. The archive may only be distributed in unmodified form.  No files may be
  136. added, changed or removed. You may not charge for this archive, other than
  137. the cost of the media and duplication fees. Distribution is allowed in all
  138. forms, such as BB systems, floppy or compact disks, and ftp sites.
  139.  
  140. Any inclusion in a commercial, semi-commercial or Shareware distribution
  141. requires the written permission of the author.
  142.  
  143. History
  144. =======
  145.  
  146. 07.06.1994  first public release (1.0)
  147. 12.09.1994  added asl filerequester (1.01)
  148. 03.10.1994  added solid mode (1.02)
  149. 09.11.1994  added perspective mode (1.03)
  150. 02.12.1994  added z-buffer (YEAH!!) (1.1)
  151. 15.12.1994  z-buffer now works with stripes (1.11)
  152. 16.12.1994  added perfect sphere and ground (with SHP2- and SHAP-Chunk)
  153. 18.12.1994  some minor changes, cleanup (2.0)
  154. 26.12.1994  fixed bug in perpective mode (problems with large objects)
  155.             moving objects with mouse in FRONT-,RIGHT- and TOP-view is now
  156.             possible
  157. 31.12.1994  added LightWave support (2.1)
  158. 02.01.1995  solid mode is now more than twice as fast
  159.             little speedup in perspective wireframe and boundingbox mode (10%)
  160. 02.01.1995  object is now automatically placed in the middle of the screen
  161. 05.01.1995  little bugfix; test if object outside was wrong
  162. 11.01.1995  added rectangles for ligtwave objects
  163.             object is now automatically zommed to fit best on screen
  164.  
  165. Author
  166. ======
  167.  
  168. For bug reports, comments, suggestions ... you can contact me at the
  169. following address.
  170.  
  171.   Andreas Heumann
  172.   Heilmeyersteige 105
  173.   89075 Ulm
  174.   Germany
  175.  
  176.   E-Mail: heumann@hugo.rz.fh-ulm.de
  177.  
  178. Thanks
  179. ======
  180.  
  181. Special thanks goes to:
  182.   Massimo Tofani
  183.   Alessio Cappelli
  184. for their postcards and suggestions,
  185.   Christian Geisert
  186. for writing through E-Mail, and
  187.   Nigel Critten
  188. for the description of the LightWave format.
  189.  
  190. Also thanks to Mike Hesser for help and motivation and to Stephan Dorenkamp
  191. for testing.
  192.  
  193. Planed for the future
  194. =====================
  195.  
  196.  - 16 color grayscale solid
  197.  - speed up (hope to get new compiler soon)
  198.